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Abstract 


The Network File System (NFS) version 4 protocol is a distributed 
file system protocol that owes its heritage to NFS protocol version 2 
(RFC 1094) and version 3 (RFC 1813). Unlike earlier versions, the 
NFS version 4 protocol supports traditional file access while 
integrating support for file locking and the MOUNT protocol. In 
addition, support for strong security (and its negotiation), COMPOUND 
operations, client caching, and internationalization has been added. 
Of course, attention has been applied to making NFS version 4 operate 
well in an Internet environment. 


RFC 7530 formally obsoletes RFC 3530. This document, together with 
RFC 7530, replaces RFC 3530 as the definition of the NFS version 4 
protocol. 

Status of This Memo 


This is an Internet Standards Track document. 


This document is a product of the Internet Engineering Task Force 


(IETF). It represents the consensus of the IETF community. It has 
received public review and has been approved for publication by the 
Internet Engineering Steering Group (IESG). Further information on 


Internet Standards is available in Section 2 of RFC 5741. 
Information about the current status of this document, any errata, 


and how to provide feedback on it may be obtained at 
http://www.rfc-editor.org/info/rfc7531. 
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1. Introduction 


This document contains the External Data Representation (XDR) 
[RFC4506] description of the NFSv4.0 protocol [RFC7530]. 


2. XDR Description of NFSv4.0 


The XDR description is provided in this document in a way that makes 
it simple for the reader to extract it into a form that is ready to 
compile. The reader can feed this document in the following shell 
script to produce the machine-readable XDR description of NFSv4.0: 


#!/bin/sh 
grep "^ *///" | sed "et */// 2?! | sed Tees E 


That is, if the above script is stored in a file called "extract.sh", 
and this document is in a file called "spec.txt", then the reader 
can do: 


sh extract.sh < spec.txt > nfs4_prot.x 


The effect of the script is to remove leading white space from each 
line, plus a sentinel sequence of "///". 


The XDR description, with the sentinel sequence, follows: 


Haynes & Noveck Standards Track [Page 3] 


RFC 7531 


NFSv4 XDR March 2015 


/// /* 
/// * This file was machine generated for [RFC7530]. 
Z// * 
/// * Last updated Tue Mar 10 11:51:21 PDT 2015. 
LK UE 
/// 
/// /* 
/// * Copyright (c) 2015 IETF Trust and the persons identified 
/// * as authors of the code. All rights reserved. 
FE 
/// * Redistribution and use in source and binary forms, with 
/// * or without modification, are permitted provided that the 
/// * following conditions are met: 
Fg c 
/// * - Redistributions of source code must retain the above 
III * copyright notice, this list of conditions and the 
JA. F following disclaimer. 
/// * 
/// * - Redistributions in binary form must reproduce the above 
///| * copyright notice, this list of conditions and the 
Lk ^k following disclaimer in the documentation and/or other 
/// * materials provided with the distribution. 
f: vk 
/// * - Neither the name of Internet Society, IETF or IETF 
JEU ek Trust, nor the names of specific contributors, may be 
/// * used to endorse or promote products derived from this 
fuz R software without specific prior written permission. 
IIL * 
/// ui THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 
/// K AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED 
/// * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
/// * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
i x FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 
/// e EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
/// A LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
/// * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
/// * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
/// * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
/// X INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
/// ^ LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
/// X OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
/// B IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
ZZ c* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
Z// "4 
/// 
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/// /* 

/// * This code was derived from RFC 7531. 

FE SER 

/// 

S Dt 

LIL * nfs4_prot.x 

/// F 

/// */ 

/// 

EE uf 

/// * Basic typedefs for RFC 1832 data type definitions 
dt: Ww 

/// /* 

/// * typedef int int32 t; 

/// * typedef unsigned int uint32 t; 

/// * typedef hyper int64 t; 

/// * typedef unsigned hyper uint64 t; 

IIL Ff 

/// 

Eide of 

/// * Sizes 

Z// */ 

/// const NFS4_FHSIZE = 128; 

/// const NFS4_VERIFIER_SIZE = 8; 

/// const NFS4_OTHER_SIZE =: Le 

/// const NFS4_OPAQUE_LIMIT = 1024; 

/// 

/// const NFSA INT64 MAX = Ox7fffffffffffffff; 
/// const NFSA UINT64 MAX = OXETfTIffffffffffft; 
/// const NFSA INT32 MAX = Ox7fffffff; 

/// const NFSA UINT32 MAX = Oxffffffff; 

/// 

/// 

/// /* 

/// * File types 

LEE Rt 

/// enum n£s ftype4 { 

/ / / NFAREG - 1, /* Regular File */ 

/// NF4DIR = 2, /* Directory */ 

Edd NF4BLK = 3, /* Special File - block device */ 
/// NF4CHR = 4, /* Special File - character device */ 
/// NF4LNK = 5, /* Symbolic Link */ 

Jf NF4SOCK = 6, /* Special File - socket */ 
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/// 
/// 
/// 
deier 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


NFAFIFO = 7, 
NF4ATTRDIR 
= 8, 
NF4NAMEDATTR 
= 9 
H; 


/* 

* Error status 

*/ 
enum nfsstat4 { 
NFSA OK 
NFSAERR PERM 
NFS4ERR_NOENT 
NFS4ERR_IO 
NFS4ERR_NXIO 
NFS4ERR_ACCESS 
NFS4ERR_EXIST 
NFS4ERR_XDEV 
/* Unused/reserved 
NFS4ERR_NOTDIR 
NFS4ERR_ISDIR 
NFS4ERR_INVAL 
NFS4ERR_FBIG 
NFS4ERR_NOSPC 
NFSAERR ROFS 
NFSAERR MLINK 
NFSAERR NAMETOOLONG 
NFSAERR NOTEMPTY 
NFSAERR DQUOT 
NFSAERR STALE 
NFSAERR BADHANDLE 
NFSAERR BAD COOKIE 
NFSAERR NOTSUPP 
NFSAERR TOOSMALL 
NFSAERR SERVERFAULT 
NFSAERR BADTYPE 
NFSAERR DELAY 
NFSAERR SAME 
NFSAERR DENIED 
NFSAERR EXPIRED 
NFSAERR LOCKED 
NFSAERR GRACE 
NFSAERR FHEXPIRED 


NFS4ERR_WRONGSEC 
NFSAERR CLID INUSI 
NFSAERR RESOURCE 


LH 
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File - fifo */ 


/* Attribute Directory */ 


/* Named Attribute */ 


*/ 


= 70, 
= 10001,/* 
= 10003,/* 
= 10004,/* 
= 10005,/* 
= 10006,/* 
= 10007,/* 
= 10008,/* 
= 10009,/* 
= 10010,/* 
= 10011,/* 
= 10012,/* 
= 10013,/* 
= 10014,/* 
= 10015,/* 
= 10016,/* 
= 10017,/* 
= 10018,/* 
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everything is okay SS 
caller not privileged xj 
no such file/directory SZ 
hard I/O error £ 
no such device */ 
access denied */ 
file already exists */ 
different file systems T 
should be a directory */ 
should not be directory  */ 
invalid argument Sa 
file exceeds server max */ 
no space on file system */ 
read-only file system SZ 
too many hard links */ 
name exceeds server max  */ 
directory not empty Kë 
hard quota limit reached */ 
file no longer exists */ 
Illegal filehandle */ 
READDIR cookie is stale  */ 
operation not supported  */ 
response limit exceeded  */ 
undefined server error x 
type invalid for CREATE */ 
file "busy" - retry * / 
nverify says attrs same */ 
lock unavailable iA 
lock lease expired SZ 
I/O failed due to lock a 
in grace period */ 
filehandle expired */ 
share reserve denied GE 
wrong security flavor ad 
clientid in use SE 
resource exhaustion * / 
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/// NFSAERR MOVED = 10019,/* file system relocated x 
/// NFSA4ERR NOFILEHANDLE = 10020,/* current FH is not set */ 
///  NFSAERR MINOR VERS MISMATCH = 10021,/* minor vers not supp */ 
/// NFSA4ERR STALE CLIENTID = 10022,/* server has rebooted */ 
/// NFSAERR STALE STATEID = 10023,/* server has rebooted */ 
/// NFSAERR OLD STATEID = 10024,/* state is out of sync */ 
/// NFSA4ERR BAD STATEID = 10025,/* incorrect stateid */ 
///  NFSAERR BAD SEQID = 10026,/* request is out of seq. ZE 
/// NFSAERR NOT. SAME = 10027,/* verify - attrs not same  */ 
/// | NFSAERR LOCK RANGE = 10028,/* lock range not supported */ 
/// NFSA4ERR SYMLINK = 10029,/* should be file/directory */ 
/// NFSA4ERR RESTOREFH = 10030,/* no saved filehandle */ 
/// NFSA4ERR, LEASE MOVED = 10031,/* some file system moved xy 
/// NES4ERR_ATTRNOTSUPP = 10032,/* recommended attr not sup */ 
/// NFES4ERR_NO_GRACE = 10033,/* reclaim outside of grace */ 
///  NFSAERR RECLAIM BAD = 10034,/* reclaim error at server  */ 
/// NFSAERR RECLAIM CONFLICT = 10035,/* conflict on reclaim */ 
///  NFSAERR BADXDR = 10036,/* XDR decode failed */ 
///  NFSAERR LOCKS HELD = 10037,/* file locks held at CLOSE */ 
/// | NFSAERR OPENMODE = 10038,/* conflict in OPEN and I/O */ 
/// NFSA4ERR BADOWNER = 10039,/* owner translation bad */ 
///  NFSAERR BADCHAR = 10040,/* UTF-8 char not supported */ 
/// | NFSAERR BADNAME = 10041,/* name not supported */ 
/// | NFSAERR BAD RANGE = 10042,/* lock range not supported */ 
///  NFSAERR LOCK NOTSUPP = 10043,/* no atomic up/downgrade Af 
/// NFSA4ERR OP ILLEGAL = 10044,/* undefined operation */ 
/// NFSA4ERR DEADLOCK = 10045,/* file locking deadlock x / 
/// NFSAERR FILE OPEN = 10046,/* open file blocks op. xy 
/// NFSAERR ADMIN REVOKED = 10047,/* lock-owner state revoked */ 
/// NFSA4ERR CB PATH DOWN = 10048 /* callback path down i 
/// i 

/// 

/// /* 

/// * Basic data types 

FILE E 

/// typedef opaque attrlist4<>; 

/// typedef uint32_t bitmap4<>; 

/// typedef uint64 t changeid4; 

/// typedef uint64 t clientid4; 

/// typedef uint32_t count4; 

/// typedef uint64 t length4; 

/// typedef uint32_t mode4; 

/// typedef uint64 t nfs_cookie4; 

/// typedef opaque nfs_fh4<NFS4_FHSIZE>; 

/// typedef uint32_t nfs_lease4; 

/// typedef uint64 t offset4; 

/// typedef uint32_t qop4; 


/// typedef opaque sec_oid4<>; 
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/// typedef uint32_t seqid4; 

/// typedef opaque utf8string<>; 

/// typedef utf8string utf8str cis; 
/// typedef utf8string utf8str cs; 
/// typedef utf8string utf8str mixed; 
/// typedef utf8str cs component4; 
/// typedef opaque linktext4<>; 

/// typedef utf8string ascii_REQUIRED4; 
/// typedef component4 pathname4<>; 
/// typedef uint64 t nfs_lockid4; 
/// typedef opaque verifier4[NFS4_VERIFIER_SIZE]; 
/// 

/// 

JE of 

/// * Timeval 

Z// KY 

/// struct nfstime4 { 

/// int64 t seconds; 

/// uint32_t nseconds; 

/// )i 

/// 

/// enum time_how4 { 

/// SET_TO_SERVER_TIME4 = 0, 

/// SET_TO_CLIENT_TIME4 = 1 

EE yrs 

/// 


/// union settime4 switch (time_how4 set it) { 
/// case SET_TO_CLIENT_TIME4: 


/// nfstime4 time; 
/// default: 

/// void; 

/// Yi 

/// 

/// 

/// /* 

/// * File attribute definitions 
Z// */ 

/// 

FIL /* 

/// * FSID structure for major/minor 
[44e EZ 

/// struct fsid4 { 

/// uint64_t major; 
/// uint64 t minor; 
/// Yi 

/// 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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/* 
* File system locations attribute for relocation/migration 
Si 

struct fs_location4 { 

utf8str cis server<>; 
pathname4 rootpath; 


D 


struct fs_locations4 { 
pathname4 fs_root; 
fs_location4 locations<>; 
DÉI 


/* 


* Various Access Control Entry definitions 


*/ 
/* 


* Mask that indicates which Access Control Entries 
* are supported. Values for the fattr4_aclsupport attribute. 


* / 
const ACL4 SUPPORT_ALLOW_ACL = 0x00000001; 
const ACL4 SUPPORT DENY ACL = 0x00000002; 
const ACL4 SUPPORT AUDIT ACL = 0x00000004; 
const ACL4 SUPPORT ALARM ACL, = 0x00000008; 


typedef uint32 t acetype4; 


/ * 


* acetype4 values; others can be added as needed. 


Wi 
const ACE4_ACCESS_ALLOWED_ACE_TYPE 
const ACE4_ACCESS_DENIED_ACE_TYPE 
const ACE4 SYSTEM AUDIT ACE TYPE 
const ACEA4 SYSTEM ALARM ACE TYPE 


/* 
* ACE flag 
Wi 

typedef uint32_t aceflag4; 
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= 0x00000000; 


0x00000001; 
0x00000002; 
0x00000003; 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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/* 
* ACE flag values 
*/ 
const ACE4 FILE INHERIT ACE = 0x00000001; 
const ACE4 DIRECTORY INHERIT ACE = 0x00000002; 
const ACE4 NO PROPAGATE INHERIT ACE = 0x00000004; 
const ACE4 INHERIT ONLY ACE = 0x00000008; 
const ACE4 SUCCESSFUL ACCESS ACE FLAG = 0x00000010; 
const ACE4 FAILED ACCESS ACE FLAG = 0x00000020; 
const ACE4 IDENTIFIER GROUP = 0x00000040; 
/* 
* ACE mask 
rA 
typedef uint32 t acemask4; 
/* 
* ACE mask values 
x 
const ACE4 READ DATA = 0x00000001; 
const ACE4 LIST DIRECTORY = 0x00000001; 
const ACE4 WRITE DATA = 0x00000002; 
const ACE4 ADD FILE = 0x00000002; 
const ACE4 APPEND DATA = 0x00000004; 
const ACE4 ADD SUBDIRECTORY = 0x00000004; 
const ACE4 READ NAMED ATTRS = 0x00000008; 
const ACE4 WRITE NAMED ATTRS = 0x00000010; 
const ACE4 EXECUTE = 0x00000020; 
const ACE4 DELETE CHILD = 0x00000040; 
const ACE4 READ ATTRIBUTES = 0x00000080; 
const ACE4 WRITE ATTRIBUTES = 0x00000100; 
const ACE4 DELETE = 0x00010000; 
const ACE4 READ ACL = 0x00020000; 
const ACEA WRITE ACL = 0x00040000; 
const ACEA WRITE OWNER = 0x00080000; 
const ACE4 SYNCHRONIZE = 0x00100000; 
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/// /* 

///  * ACEA GENERIC READ - defined as a combination of 
fit F ACE4_READ_ACL | 

ee E ACE4_READ_DATA | 

kik vk ACE4_READ_ATTRIBUTES | 

/// * ACE4_SYNCHRONIZE 

Z// ¥*/ 

/// 

/// const ACE4_GENERIC_READ = 0x00120081; 
/// 

/// /* 

///  * ACEA GENERIC WRITE - defined as a combination of 
[pe S ACE4 READ ACL | 

nr E ACE4 WRITE DATA | 

EF. UN ACE4 WRITE ATTRIBUTES | 

Lit A ACE4_WRITE_ACL | 

IIE F ACE4_APPEND_DATA | 

ILo * ACE4_SYNCHRONIZE 

Z// ¥*/ 

/// const ACE4_GENERIC_WRITE = 0x00160106; 
/// 

/// 

/// /* 

///  * ACEA GENERIC EXECUTE - defined as a combination of 
/// * ACE4_READ_ACL 

/// * ACEA4 READ ATTRIBUTES 

ZII * ACE4_EXECUTE 

IIL * ACE4_SYNCHRONIZE 

LII ¥*/ 

/// const ACE4_GENERIC_EXECUTE = 0x001200A0; 
/// 

/// 

/// /* 

///  * Access Control Entry definition 

FILS ¥*/ 

/// struct nfsace4 { 

/// acetype4 type; 
/// aceflag4 flag; 
/// acemask4 access_mask; 
/// utf8str mixed who; 

/// )i 

/// 
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/// 

/// /* 

/// * Field definitions for the fattr4 mode attribute 
[Ju Uy 


/// const MODE4 SUID = 0x800; /* set user id on execution */ 
/// const MODEA SGID = 0x400; /* set group id on execution */ 
/// const MODE4_SVTX = 0x200; /* save text even after use */ 
/// const MODE4_RUSR = 0x100; /* read permission: owner */ 
/// const MODE4_WUSR = 0x080; /* write permission: owner */ 
/// const MODE4_XUSR = 0x040; /* execute permission: owner */ 
/// const MODEA RGRP = 0x020; /* read permission: group */ 
/// const MODE4_WGRP = 0x010; /* write permission: group */ 
/// const MODEA XGRP = 0x008; /* execute permission: group */ 
/// const MODE4_ROTH = 0x004; /* read permission: other */ 
/// const MODE4_WOTH = 0x002; /* write permission: other */ 
/// const MODE4_XOTH = 0x001; /* execute permission: other */ 
/// 

/// 

"TEE 

/// * Special data/attribute associated with 

/// * file types NF4BLK and NFACHR. 

Z// */ 

/// struct specdata4 { 

/// uint32 t specdatal; /* major device number */ 

/// uint32 t specdata2; /* minor device number */ 


FEY 

/// 

/// 

/// /* 

/// * Values for fattr4_fh_expire_type 

Lips, Rf 

/// const FH4_PERSISTENT = 0x00000000; 

/// const FHA NOEXPIRE WITH OPEN = 0x00000001; 

/// const FHA4 VOLATILE ANY = 0x00000002; 

/// const FH4_VOL_MIGRATION = 0x00000004; 

/// const FH4_VOL_RENAME = 0x00000008; 

/// 

/// 

/// typedef bitmap4 fattr4_supported_attrs; 
/// typedef nfs_ftype4 fattr4_type; 

/// typedef uint32_t fattr4_fh_expire_type; 
/// typedef changeid4 fattr4_change; 

/// typedef uint64 t fattr4_size; 

/// typedef bool fattr4_link_support; 
/// typedef bool fattr4_symlink_support; 
/// typedef bool fattr4_named_attr; 

/// typedef fsid4 fattr4_fsid; 
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/// typedef bool fattr4_unique_handles; 
/// typedef nfs_lease4 fattr4_lease_time; 

/// typedef nfsstat4 fattr4_rdattr_error; 

/// 

/// typedef nfsace4 fattr4_acl<>; 

/// typedef uint32_t fattr4_aclsupport; 

/// typedef bool fattr4_archive; 

/// typedef bool fattr4_cansettime; 

/// typedef bool fattr4_case_insensitive; 
/// typedef bool fattr4_case_preserving; 
/// typedef bool fattr4_chown_restricted; 
/// typedef uint64 t fattr4_fileid; 

/// typedef uint64 t fattr4_files_avail; 

/// typedef nfs_fh4 fattr4_filehandle; 

/// typedef uint64 t fattr4_files_free; 

/// typedef uint64 t fattr4_files_total; 

/// typedef fs_locations4 fattr4_fs_locations; 

/// typedef bool fattr4_hidden; 

/// typedef bool fattr4_homogeneous; 

/// typedef uint64 t fattr4_maxfilesize; 

/// typedef uint32_t fattr4_maxlink; 

/// typedef uint32_t fattr4_maxname; 

/// typedef uint64 t fattr4_maxread; 

/// typedef uint64 t fattr4_maxwrite; 

/// typedef ascii_REQUIRED4 fattr4_mimetype; 

/// typedef mode4 fattr4_mode; 

/// typedef uint64 t fattr4_mounted_on_fileid; 
/// typedef bool fattr4_no_trunc; 

/// typedef uint32_t fattr4_numlinks; 

/// typedef utf8str mixed fattr4_owner; 

/// typedef utf8str_mixed fattr4_owner_group; 

/// typedef uint64 t fattr4_quota_avail_hard; 
/// typedef uint64 t fattr4_quota_avail_soft; 
/// typedef uint64 t fattr4_quota_used; 

/// typedef specdata4 fattr4_rawdev; 

/// typedef uint64 t fattr4_space_avail; 

/// typedef uint64 t fattr4_space_free; 

/// typedef uint64 t fattr4_space_total; 

/// typedef uint64 t fattr4_space_used; 

/// typedef bool fattr4_system; 

/// typedef nfstime4 fattr4_time_access; 

/// typedef settime4 fattr4_time_access_set; 
/// typedef nfstime4 fattr4_time_backup; 

/// typedef nfstime4 fattr4_time_create; 

/// typedef nfstime4 fattr4_time_delta; 

/// typedef nfstime4 fattr4_time_metadata; 
/// typedef nfstime4 fattr4_time_modify; 

/// typedef settime4 fattr4_time_modify_set; 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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* Mandatory attributes 


Wi 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 


/* 


FATTR4_SUPPORTED_ATTRS 
FATTR4_TYPE 
FATTR4_FH_EXPIRE_TYPE 
FATTR4_CHANGE 
FATTR4_SIZE 
FATTR4_LINK_SUPPORT 
FATTR4_SYMLINK_SUPPORT 
FATTR4_NAMED_ATTR 
FATTR4_FSID 
FATTR4_UNIQUE_HANDLES 
FATTR4_LEASE_TIME 
FATTR4_RDATTR_ERROR 
FATTR4_FILEHANDLE 


* Recommended attributes 


Wi 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 


FATTR4_ACL 
FATTR4_ACLSUPPORT 
FATTR4_ARCHIVE 
FATTR4_CANSETTIME 
FATTR4_CASE_INSENSITIVE 
FATTR4_CASE_PRESERVING 
FATTR4_CHOWN_RESTRICTED 
FATTR4_FILEID 
FATTR4_FILES_AVAIL 
FATTR4_FILES_FREE 
FATTR4_FILES_TOTAL 
FATTR4_FS_LOCATIONS 
FATTR4_HIDDEN 
FATTR4_HOMOGENEOUS 
FATTR4_MAXFILESIZE 
FATTR4_MAXLINK 
FATTR4_MAXNAME 
FATTR4_MAXREAD 
FATTR4_MAXWRITE 
FATTR4_MIMETYPE 
FATTR4_MODE 
FATTR4_NO_TRUNC 
FATTR4_NUMLINKS 
FATTR4_OWNER 
FATTR4_OWNER_GROUP 
FATTRA QUOTA AVAIL HARD 


M ar 8€ Ne 


mm 


M ae 


RP 


VO OO JO OG A l2m| OH 
`~ 


12; 
13; 
14; 
15; 
16; 
17; 
18; 
20; 
21; 
22; 
23; 
24; 
25; 
26; 
27; 
28; 
29; 
30; 
31; 
32; 
33; 
34; 
35; 
36; 
37; 
= 38; 
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/// const FATTR4_QUOTA_AVAIL_SOFT = 39; 
/// const FATTR4_QUOTA_USED = 40; 
/// const FATTR4_RAWDEV = 41; 
/// const FATTR4_SPACE_AVAIL = 42; 
/// const FATTR4_SPACE_FREE = 43; 
/// const FATTR4_SPACE_TOTAL = 44; 
/// const FATTR4_SPACE_USED = 45; 
/// const FATTR4_SYSTEM = 46; 
/// const FATTR4_TIME_ACCESS = 47; 
/// const FATTR4_TIME_ACCESS_SET = 48; 
/// const FATTR4_TIME_BACKUP = 49; 
/// const FATTR4_TIME_CREATE = 50; 
/// const FATTR4_TIME_DELTA ET 
/// const FATTRA TIME METADATA = 52; 
/// const FATTR4_TIME_MODIFY ECH 
/// const FATTR4_TIME_MODIFY_SET = 54; 
/// const FATTR4_MOUNTED_ON_FILEID = 55; 
/// 

"TEES 

/// * File attribute container 

Ju ku 

/// struct fattr4 { 

/// bitmap4 attrmask; 

/// attrlist4 attr_vals; 
EE yes 

/// 

/// 

/// /* 

/// * Change info for the client 

/// K 

/// struct change_info4 { 

/// bool atomic; 

/// changeid4 before; 

/// changeid4 after; 

/// )i 

/// 

/// 

/// struct clientaddr4 { 

/// /* see struct rpcb in RFC 1833 */ 
T m string r netid«»; /* network id */ 
/// string r_addr<>; /* universal address */ 
ZZZ 43 

/// 
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/// 

/// /* 

/// * Callback program info as provided by the client 
LIR */ 

/// struct cb client4 { 

/// unsigned int cb program; 

/// clientaddr4 cb location; 

/// )i 

/// 

/// 

/// AF 

/// * Stateid 

FIE */ 

/// struct stateid4 { 

/// uint32_t seqid; 

/// opaque other [NFS4_OTHER_SIZE]; 
/// )i 

/// 

/// f* 

/// * Client ID 

Te NES 

/// struct nfs client idA4 { 

/// verifier4 verifier; 

/// opaque id«NFS4 OPAQUE LIMIT»; 
/// )i 

/// 

/// 

/// struct open_owner4 { 

/// clientid4 clientid; 

/// opaque owner<NFS4_OPAQUE_LIMIT>; 
/// )i 

/// 

/// 

/// struct lock_owner4 { 

/// clientid4 clientid; 

/// opaque owner<NFS4_OPAQUE_LIMIT>; 
/// 3; 

/// 

/// 

/// enum nfs_lock_type4 { 

/// READ_LT = 1, 

/// WRITE_LT Em 

/// READW_LT = 3, /* blocking read */ 
/// WRITEW_LT 4 /* blocking write */ 
/// )i 

/// 
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/// 

/// const ACCESS4_READ = 0x00000001; 
/// const ACCESS4_LOOKUP = 0x00000002; 
/// const ACCESS4_MODIFY = 0x00000004; 
/// const ACCESS4_EXTEND = 0x00000008; 
/// const ACCESS4_DELETE = 0x00000010; 
/// const ACCESS4_EXECUTE = 0x00000020; 
/// 

/// struct ACCESS4args { 

/// /* CURRENT_FH: object */ 

/// uint32_t access; 

/// Y 

/// 

/// struct ACCESS4resok { 

/// uint32 t supported; 
/// uint32_t access; 

/// y; 

/// 


/// union ACCESS4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// ACCESS4resok resok4; 
/// default: 

/// void; 

SEEN 

Edd 

/// struct CLOSE4args { 

27. /* CURRENT FH: object */ 
/// seqid4 seqid; 
/// stateid4 open_stateid; 
Vids ka 

/// 


/// union CLOSE4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// stateid4 open_stateid; 
/// default: 

/// void; 

/// )i 

/// 

/// struct COMMIT4args { 

/// /* CURRENT_FH: file */ 

/// offset4 offset; 
/// count4 count; 

/// )i 

/// 

/// struct COMMIT4resok { 

/// verifier4 writeverf; 
i ae or 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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union COMMIT4res switch (nfsstat4 status) 


case NFSA OK: 

COMMITAresok resok4; 
default: 

void; 


Ir 


union createtype4 switch (nfs_ftype4 type) 


case NF4LNK: 
linktext4 linkdata; 
case NF4BLK: 
case NF4CHR: 
specdata4 devdata; 
case NF4SOCK: 
case NF4FIFO: 
case NF4DIR: 
void; 
default: 


{ 


{ 
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void; /* server should return NFS4ERR_BADTYPE */ 


D 


struct CREATE4args { 


/* CURRENT_FH: directory for creation */ 


createtype4 objtype; 
component4 objname; 
fattr4 createattrs; 


D 


struct CREATE4resok { 
change_info4 cinfo; 
bitmap4 attrset; 
}; 


union CREATE4res switch (nfsstat4 status) 


case NFS4_OK: 

CREATE4resok resok4; 
default: 

void; 


1: 


struct DELEGPURGE4args { 
clientid4 clientid; 
DÉI 


struct DELEGPURGF4res { 


nfsstat4 status; 
D 
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/// struct DELEGRETURN4args { 


fii /* CURRENT_FH: delegated file */ 
/// stateid4 deleg_stateid; 
/// )i 

/// 

/// struct DELEGRETURN4res { 

/// nfsstat4 status; 

/// )i 

/// 

/// struct GETATTR4args { 

/// /* CURRENT_FH: directory or file */ 
/// bitmap4 attr_request; 
FIF 

EL 

/// struct GETATTR4resok { 

/// fattr4 obj_attributes; 
TAL Es 

/// 


/// union GETATTR4res switch (nfsstat4 status) { 
/// case NFSA OK: 

/// GETATTR4resok resok4; 

/// default: 

/// void; 

/// Y 

/// 

/// struct GETFH4resok { 

/// nfs_fh4 object; 

/// Y 

/// 

/// union GETFH4res switch (nfsstat4 status) { 
/// case NFSA OK: 


/// GETFH4resok resok4; 

/// default: 

/// void; 

/// )i 

/// 

/// struct LINK4args { 

/// /* SAVED_FH: source object */ 
/// /* CURRENT_FH: target directory */ 
/// component4 newname; 

/// )i 

/// 

/// struct LINK4resok { 

/// change_info4 cinfo; 

/// )i 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
deier 
/// 
/// 
/// 
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union LINK4res switch (nfsstat4 status) { 
case NFS4_OK: 


LINK4resok resok4; 
default: 
void; 
DÉI 
/* 
* For LOCK, transition from open owner to new lock owner 
zÄ 
struct open to lock owner4 { 
seqid4 open seqid; 
stateid4 open_stateid; 
seqid4 lock_seqid; 
lock_owner4 lock owner; 
DÉI 
/* 
* For LOCK, existing lock owner continues to request file 1 
*/ 
struct exist lock owner4 { 
stateid4 lock_stateid; 
seqid4 lock_seqid; 
DÉI 
union locker4 switch (bool new_lock_owner) { 


case TRUE: 


open_to_lock_owner4 open_owner; 


case FALSE: 


D 
/* 


exist_lock_owner4 lock owner; 


* LOCK/LOCKT/LOCKU: Record lock management 


*/ 


struct 


Ir 


LOCK4args { 
/* CURRENT_FH: file */ 
nfs lock type4  locktype; 


bool reclaim; 
offset4 offset; 
length4 length; 
locker4 locker; 
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/// struct LOCK4denied { 


/// offset4 offset; 

/// length4 length; 

/// nfs lock type4 locktype; 

/// lock_owner4 owner; 

/// i 

/// 

/// struct LOCK4resok { 

/// stateid4 lock_stateid; 
LE 

/// 


/// union LOCK4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


KL LOCK4resok resok4; 
/// case NFS4ERR_DENIED: 

/// LOCK4denied denied; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct LOCKT4args { 

/// /* CURRENT_FH: file */ 
/// nfs lock type4  locktype; 
/ / / offset4 offset; 
/// length4 length; 
/// lock_owner4 owner; 
/// Yi 

/// 


/// union LOCKT4res switch (nfsstat4 status) { 
/// case NFS4ERR_DENIED: 


/// LOCK4denied denied; 
/// case NFSA OK: 

/// void; 

/// default: 

/// void; 

/// ir 

/// 

/// struct LOCKU4args { 

/// /* CURRENT_FH: file */ 
fff nfs lock type4 locktype; 
/// seqid4 seqid; 
/// stateid4 lock_stateid; 
/// offset4 offset; 
/// length4 length; 
/// ir 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


union LOCKU4res switch 
case NFS4_OK: 
stateid4 


default: 


1: 


struct 


D 


struct 


D 


struct 


Ir 


struct 


1: 


void; 


LOOKUP4args { 
/* CURRENT_FH: 


component4 


LOOKUP4res { 
/* CURRENT_FH: 
nfsstat4 


LOOKUPP4res { 
/* CURRENT_FH: 
nfsstat4 


NVERIFY4args { 
/* CURRENT_FH: 


fattr4 


NFSv4 XDR 


(nfsstat4 status) { 


lock, stateid; 


directory */ 
objname; 


object */ 
status; 


directory */ 
status; 


object */ 
obj attributes; 


struct NVERIFY4res { 
nfsstat4 status; 
DÉI 
const OPEN4_SHARE_ACCESS_READ = 0x00000001; 
const OPEN4_SHARE_ACCESS_WRITE = 0x00000002; 
const OPEN4_SHARE_ACCESS_BOTH = 0x00000003; 
const OPENA SHARE DENY NONE = 0x00000000; 
const OPEN4 SHARE DENY READ = 0x00000001; 
const OPEN4 SHARE DENY WRITE = 0x00000002; 
const OPEN4 SHARE DENY BOTH = 0x00000003; 
/* 
* Various definitions for OPEN 
*/ 
enum createmode4 { 
UNCHECKED4 = 0, 
GUARDED4 = 1, 
EXCLUSIVE4 = 2 


D 


Haynes & Noveck 


Standards Track 


March 2015 


[Page 22] 


RFC 7531 NFSv4 XDR March 2015 


/// union createhow4 switch (createmode4 mode) { 
/// case UNCHECKED4: 
/// case GUARDED4: 


/// fattr4 createattrs; 
/// case EXCLUSIVE4: 

/// verifier4 createverf; 
/// )i 

/// 

/// enum opentype4 { 

/// OPEN4_NOCREATE = 0, 

/// OPEN4_CREATE =o 

/// )i 

/// 


/// union openflag4 switch (opentype4 opentype) { 
/// case OPEN4_CREATE: 


/// createhow4 how; 
/// default: 

/// void; 

/// )i 

/// 


/// /* Next definitions used for OPEN delegation */ 
/// enum limit_by4 { 


/// NFS_LIMIT_SIZE E 

/// NFS_LIMIT_BLOCKS 2572 

/// /* others as needed */ 

/// )i 

/// 

/// struct nfs_modified_limit4 { 

/// uint32_t num_blocks; 

/// uint32_t bytes_per_block; 
T4) 

/// 


/// union nfs_space_limit4 switch (limit_by4 limitby) { 
/// /* limit specified as file size */ 

/// case NFS_LIMIT_SIZE: 

/// uint64 t filesize; 

/// /* limit specified by number of blocks */ 

/// case NFS LIMIT BLOCKS: 


/// nfs_modified_limit4 mod_blocks; 
EE A, 

/// 

/// enum open_delegation_type4 { 

/// OPEN_DELEGATE_NONE = 0, 

/// OPEN DELEGATE READ EE 

/// OPEN_DELEGATE_WRITE = 2 

Lg, y 

/// 
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/// enum open_claim_type4 { 


//1 CLAIM_NULL = 0, 

/// CLAIM_PREVIOUS zs 

/// CLAIM_DELEGATE_CUR = 2, 

/// CLAIM_DELEGATE_PREV zu 

/// )i 

/// 

/// struct open_claim_delegate_cur4 { 

/// stateid4 delegate_stateid; 
/// component4 file; 

FEE Y 

/// 

/// union open_claim4 switch (open_claim_type4 claim) { 
gy f* 


/// * No special rights to file. 
/// * Ordinary OPEN of the specified file. 


/// Wi 

/// case CLAIM_NULL: 

/// /* CURRENT_FH: directory */ 

/// component4 file; 

IAA /* 

/// * Right to the file established by an 
/// * open previous to server reboot. File 


/// * identified by filehandle obtained at 
/// * that time rather than by name. 


/// rd 

/// case CLAIM PREVIOUS: 

/// /* CURRENT_FH: file being reclaimed */ 
/// open_delegation_type4 delegate_type; 
/// 

o MP AE 


/// * Right to file based on a delegation 
/// * granted by the server. File is 
/// * specified by name. 


/// ai 

/// case CLAIM DELEGATE CUR: 

/// /* CURRENT_FH: directory */ 

/// open_claim_delegate_cur4 delegate_cur_info; 
/// 

/[//. f* 

/// * Right to file based on a delegation 

/// * granted to a previous boot instance 

/// * of the client. File is specified by name. 
/// */ 

/// case CLAIM DELEGATE PREV: 

/// /* CURRENT_FH: directory */ 

/// component4 file_delegate_prev; 
/// )i 
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/// 

/// /* 

///  * OPEN: Open a file, potentially receiving an open delegation 
Idd OZ 

/// struct OPEN4args { 

/// seqid4 seqid; 

/// uint32_t share_access; 

/// uint32_t share_deny; 

/// open_owner4 owner; 

/// openflag4 openhow; 

/// open_claim4 claim; 

/// Y 

/// 

/// struct open_read_delegation4 { 

/// stateid4 stateid; /* Stateid for delegation */ 
/// bool recall; /* Pre-recalled flag for 

/// delegations obtained 

/// by reclaim (CLAIM_PREVIOUS). */ 
/// 

/// nfsace4 permissions; /* Defines users who don't 
/// need an ACCESS call to 

/// open for read. */ 

/// Ya 

/// 

/// struct open_write_delegation4 { 

/// stateid4 stateid; /* Stateid for delegation */ 
/// bool recall; /* Pre-recalled flag for 
/// delegations obtained 

/// by reclaim 

/// (CLAIM PREVIOUS). */ 

/// 

/// nfs space limit4 

/// space_limit; /* Defines condition that 
/// the client must check to 
/// determine whether the 
/// file needs to be flushed 
/// to the server on close. */ 
/// 

/// nfsace4 permissions; /* Defines users who don't 
/// need an ACCESS call as 
/// part of a delegated 

/// open. */ 

/// tr 

/// 
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/// 
/// 
/// 
Je 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


Haynes & 


union open_delegation 
switch (open_delegati 


NFSv4 XDR 


4 
on_type4 delegation_type) { 


case OPEN _ DELEGATE NONE: 


void; 


case OPEN DELEGATE READ: 


open . 


read delegation4 read: 


case OPEN DELEGATE WRITE: 
open write delegation4 write; 


H; 


/* 
* Result flags 
X 


/* Client must confirm open */ 

const OPENA RESULT CONFIRM = 0x00000002; 

/* Type of file locking behavior at the server */ 
const OPENA RESULT LOCKTYPE POSIX = 0x00000004; 


struct OPEN4resok { 
stateid4 st 


ateid; /* Stateid for open */ 
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change_info4 cinfo; /* Directory change info */ 


uint32_t T 


lags; /* Result flags */ 


bitmap4 attrset; /* attribute set for create */ 


open delegation4 de 
; 


union OPEN4res switch 
case NFSA OK: 


legation; /* Info on any open 
delegation */ 


(nfsstat4 status) { 


/* CURRENT FH: opened file */ 


OPEN4resok 
default: 
void; 


1: 


struct OPENATTR4args 
/* CURRENT_FH 


resok4; 


{ 
: object */ 


bool createdir; 


1: 


struct OPENATTR4res { 


/* CURRENT_FH: 


nfsstat4 
1: 


Noveck 


named attr directory */ 
status; 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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struct OPEN _CONFIRM4a 
/* CURRENT_FH 
stateid4 
seqid4 

DÉI 


NFSv4 XDR 


rgs A 


: opened file */ 


open_stateid; 
seqid; 


struct OPEN CONFIRM4resok { 


stateid4 
}; 


union OPEN _CONFIRM4re 
case NFSA OK: 


OPEN CONFIRMA4resok 


default: 
void; 


D 


struct OPEN_DOWNGRADE 
/* CURRENT_FH 
stateid4 
seqid4 
uint32_t 
uint32_t 

DÉI 


struct OPEN_DOWNGRADE 
stateid4 
1: 


union OPEN DOWNGRADEA4 
case NFSA OK: 


OPEN DOWNGRADE4resok 


default: 
void; 


H; 


struct PUTFH4args { 
nfs_fh4 
DÉI 


struct PUTFH4res { 


/* CURRENT_FH: 


nfsstat4 
D 


Noveck 


open_stateid; 


s switch (nfsstat4 status) 


4args { 


: opened file */ 


open_stateid; 
seqid; 

share access; 
share deny; 


4resok { 
open_stateid; 


res switch (nfsstat4 status) 


object; 


X 


status; 
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/// struct PUTPUBFH4res { 


fii /* CURRENT_FH: public fh */ 
/// nfsstat4 status; 
/// )i 

/// 

/// struct PUTROOTFH4res { 

/// /* CURRENT_FH: root fh */ 
/// nfsstat4 status; 
Ja ks 

/// 

/// struct READ4args { 

/// /* CURRENT_FH: file */ 
/// stateid4 stateid; 
KL offset4 offset; 
/// count4 count; 
HT AG 

/// 

/// struct READ4resok { 

/// bool eof; 

/// opaque data<>; 
/// )i 

/// 


/// union READ4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// READ 4resok resok4; 

/// default: 

/// void; 

/// y; 

/// 

/// struct READDIR4args { 

/// /* CURRENT_FH: directory */ 
/// nfs_cookie4 cookie; 

/// verifier4 cookieverf; 
/// count4 dircount; 
/// count4 maxcount; 
/// bitmap4 attr_request; 
/// )i 

/// 

/// struct entry4 { 

/// nfs_cookie4 cookie; 

/// component4 name; 

/// fattr4 attrs; 

/// entry4 *nextentry; 
AL 

/// 


Haynes & Noveck Standards Track [Page 28] 


RFC 7531 NFSv4 XDR March 2015 


/// struct dirlist4 { 


/// entry4 *entries; 
/// bool eof; 

/// )i 

/// 

/// struct READDIR4resok { 

/// verifier4 cookieverf; 
/// dirlist4 reply; 

ZC ys 

/// 

/// 


/// union READDIR4res switch (nfsstat4 status) { 
/// case NFSA OK: 

/// READDIR4resok resok4; 

/// default: 

/// void; 

/// y; 

/// 

/// 

/// struct READLINK4resok { 

/// linktext4 link; 

/// Y 

/// 

/// union READLINK4res switch (nfsstat4 status) { 
/// case NFSA OK: 


/// READLINK4resok resok4; 
/// default: 

/// void; 

/// Y 

/// 

/// struct REMOVE4args { 

/// /* CURRENT_FH: directory */ 
/// component4 target; 
/// Y 

/// 

/// struct REMOVE4resok { 

/// change_info4 cinfo; 
/// Y 

/// 


/// union REMOVE4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// REMOVE 4resok resok4; 
/// default: 

/// void; 

/// )i 

/// 
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/// struct RENAME4args { 


/// /* SAVED_FH: source directory */ 
/// component4 oldname; 

/// /* CURRENT_FH: target directory */ 
/// component4 newname; 

/// )i 

/// 

/// struct RENAME4resok { 

/// change_info4 source_cinfo; 
/// change_info4 target_cinfo; 
/// )i 

/// 


/// union RENAME4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// RENAME 4resok resok4; 
/// default: 

/// void; 

/// Y 

/// 

/// struct RENEW4args { 

/// clientid4 clientid; 
/// Y 

/// 

/// struct RENEW4res { 

/// nfsstat4 status; 

/// Y 

/// 

/// struct RESTOREFH4res { 

/// /* CURRENT_FH: value of saved fh */ 
/// nfsstat4 status; 

/// Y 

{Il 

/// struct SAVEFH4res { 

/// /* SAVED_FH: value of current fh */ 
/// nfsstat4 status; 

/// Y 

/// 

/// struct SECINFO4args { 

/// /* CURRENT_FH: directory */ 
/// component4 name; 

/// Y 

/// 
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/// /* 

/// * From RFC 2203 

FA GET 

/// enum rpc gss svo t { 

/// RPC_GSS_SVC_NONE 21; 
/// RPC_GSS_SVC_INTEGRITY = 2, 
/// RPC_GSS_SVC_PRIVACY = 3 
/// )i 

/// 

/// struct rpcsec_gss_info { 

/// sec_oid4 oid; 

/// qop4 qop; 

/// rpc_gss_svc_t service; 
EE 

/// 


/// /* RPCSEC_GSS has a value of '6'. See RFC 2203 */ 
/// union secinfo4 switch (uint32_t flavor) { 
/// case RPCSEC_GSS: 

/// rpcsec_gss_info flavor_info; 
/// default: 

/// void; 

/// y; 

/// 

/// typedef secinfo4 SECINFO4resok<>; 

/// 

/// union SECINFO4res switch (nfsstat4 status) { 
/// case NFSA OK: 


/// SECINFO4resok resok4; 

/// default: 

/// void; 

dd Ys 

/// 

/// struct SETATTR4args { 

/// /* CURRENT_FH: target object */ 
/// stateid4 stateid; 

/// fattr4 obj_attributes; 
/// )i 

/// 

/// struct SETATTR4res { 

/// nfsstat4 status; 

/// bitmap4 attrsset; 

/// )i 

/// 

/// struct SETCLIENTID4args { 

/// nfs_client_id4 client; 

/// cb client4 callback; 

/// uint32_t callback_ident; 
/// )i 
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/// 

/// struct SETCLIENTID4resok { 

/// clientid4 clientid; 

/// verifier4 setclientid_confirm; 
/// )i 

/// 


/// union SETCLIENTID4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// SETCLIENTID4resok resok4; 
/// case NFS4ERR_CLID_INUSE: 

/// clientaddr4 client_using; 
/// default: 

/// void; 

E 3 

/// 

/// struct SETCLIENTID_CONFIRM4args { 

/// clientid4 clientid; 

/// verifier4 setclientid_confirm; 
TAL NG 

/// 

/// struct SETCLIENTID_CONFIRM4res { 

/// nfsstat4 status; 

HT ya 

/// 

/// struct VERIFY4args { 

/// /* CURRENT_FH: object */ 

/// fattr4 obj_attributes; 
/// y; 

/// 

/// struct VERIFY4res { 

/// nfsstat4 status; 

/// )i 

/// 

/// enum stable_how4 { 

/// UNSTABLE4 zu. 

/// DATA_SYNC4 zc. 

/// FILE_SYNC4 = 2 

SIL F? 

/// 

/// struct WRITE4args { 

/// /* CURRENT_FH: file */ 

/// stateid4 stateid; 

/// offset4 offset; 

/// stable_how4 stable; 

/// opaque data<>; 

Idd y 

/// 
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struct WRITE4resok { 
count4 count; 
stable_how4 committed; 
verifier4 writeverf; 


1: 


union WRITE4res switch (nfsstat4 status) { 
case NFS4_OK: 
WRITE4resok resok4; 
default: 
void; 


D 


struct RELEASE_LOCKOWNER4args { 
lock_owner4 lock owner; 


D 


struct RELEASE LOCKOWNER4res { 
nfsstat4 status; 
D 


struct ILLEGAI4res { 


nfsstat4 status; 

DÉI 

/* 

* Operation arrays 

x 

enum nfs opnum4 { 

OP ACCESS = 3, 
OP_CLOSE = 4, 
OP_COMMIT P 
OP CREATE = 6, 
OP DELEGPURGE = 7, 
OP_DELEGRETURN = 8, 
OP_GETATTR = 9, 
OP_GETFH = 10, 
OP_LINK = 11, 
OP_LOCK = 12, 
OP_LOCKT = 13, 
OP_LOCKU = 14, 
OP_LOOKUP = 15, 
OP_LOOKUPP = 16, 
OP_NVERIFY = 17, 
OP_OPEN = 18, 
OP_OPENATTR = 19, 
OP OPEN CONFIRM = 20, 
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OP_OPEN_DOWNGRADE 


OP_PUTFH 


OP_PUTPUBFH 
OP_PUTROOTFH 


OP_READ 


OP_READDIR 
OP_READLINK 
OP_REMOVE 
OP_RENAME 
OP_RENEW 
OP_RESTOREFH 
OP_SAVEFH 
OP_SECINFO 
OP_SETATTR 
OP_SETCLIENTID 


OP_SETCLIENTID_CONFIRM 


OP_VERIFY 
OP_WRITE 


OP RELEASE LOCKOWNER 


OP ILLEGAL 


H; 


union 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 


case 
case 
case 
case 
case 


nfs argop4 switch 


OP, ACCESS: 

OP CLOSE: 

OP, COMMIT: 

OP, CREATE: 

OP. DELEGPURGE: 
OP. DELEGRETURN: 
OP GETATTR: 

OP GETFH: 

OP LINK: 

OP, LOCK: 

OP. LOCKT: 

OP, LOCKU: 

OP. LOOKUP: 

OP. LOOKUPP: 
OP. NVERIFY: 
OP, OPEN: 

OP OPENATTR: 


OP OPEN CONFIRM: 
OP OPEN DOWNGRADE: 


OP PUTFH: 

OP PUTPUBFH: 
OP PUTROOTFH: 
OP. READ: 

OP. READDIR: 


Gl D 
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(nfs opnum4 argop) { 
ACCESS4args opaccess; 
CLOSE4args opclose; 

COMMIT4args opcommit; 
CREATE4args opcreate; 
DELEGPURGE4args opdelegpurge; 
DELEGRETURN4args opdelegreturn; 
GETATTR4args opgetattr; 

void; 

LINK4args oplink; 

LOCK4args oplock; 

LOCKT4args oplockt; 

LOCKU4args oplocku; 

LOOKUP4args oplookup; 

void; 

NVERIFY4args opnverify; 
OPEN4args opopen; 

OPENATTR4args opopenattr; 
OPEN_CONFIRM4args opopen confirm; 


2015 


OPEN DOWNGRADE4args opopen downgrade; 


PUTFH4args opputfh; 
void; 

void; 

READ4args opread; 
READDIR4args opreaddir; 
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/// case OP_READLINK: void; 

/// case OP_REMOVE: REMOVE4args opremove; 

/// case OP_RENAME: RENAME4args oprename; 

/// case OP_RENEW: RENEW4args oprenew; 

/// case OP_RESTOREFH: void; 

/// case OP_SAVEFH: void; 

/// case OP_SECINFO: SECINFO4args opsecinfo; 

/// case OP_SETATTR: SETATTR4args opsetattr; 

/// case OP_SETCLIENTID: SETCLIENTID4args opsetclientid; 
/// case OP SETCLIENTID CONFIRM: SETCLIENTID_CONFIRM4args 
/// opsetclientid_confirm; 
/// case OP_VERIFY: VERIFY4args opverify; 

/// case OP_WRITE: WRITE4args opwrite; 

/// case OP_RELEASE_LOCKOWNER: 

/// RELEASE_LOCKOWNER4args 

/// oprelease_lockowner; 

/// case OP_ILLEGAL: void; 

HIR 

/// 

/// union nfs_resop4 switch (nfs_opnum4 resop) { 

/// case OP_ACCESS: ACCESS4res opaccess; 

/// case OP_CLOSE: CLOSE4res opclose; 

/// case OP_COMMIT: COMMIT4res opcommit; 

/// case OP_CREATE: CREATE4res opcreate; 

/// case OP_DELEGPURGE: DELEGPURGE4res opdelegpurge; 
/// case OP_DELEGRETURN: DELEGRETURN4res opdelegreturn; 
/// case OP_GETATTR: GETATTR4res opgetattr; 

/// case OP_GETFH: GETFH4res opgetfh; 

/// case OP_LINK: LINK4res oplink; 

/// case OP_LOCK: LOCK4res oplock; 

/// case OP_LOCKT: LOCKT4res oplockt; 

/// case OP_LOCKU: LOCKU4res oplocku; 

/// case OP_LOOKUP: LOOKUP4res oplookup; 

/// case OP_LOOKUPP: LOOKUPP4res oplookupp; 

/// case OP_NVERIFY: NVERIFY4res opnverify; 

/// case OP_OPEN: OPEN4res opopen; 

/// case OP OPENATTR: OPENATTR4res opopenattr; 

/// case OP. OPEN CONFIRM: OPEN_CONFIRM4res opopen confirm; 
/// case OP. OPEN DOWNGRADE: 

/// OPEN_DOWNGRADE4res 

/// opopen_downgrade; 

/// case OP_PUTFH: PUTFH4res opputfh; 

/// case OP_PUTPUBFH: PUTPUBFH4res opputpubfh; 

/// case OP_PUTROOTFH: PUTROOTFH4res opputrootfh; 

/// case OP_READ: READ4res opread; 

/// case OP_READDIR: READDIR4res opreaddir; 

/// case OP_READLINK: READLINK4res opreadlink; 

/// case OP. REMOVE: REMOVE4res opremove; 
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case OP_RENAME: 

case OP_RENEW: 

case OP_RESTOREFH: 
case OP_SAVEFH: 

case OP_SECINFO: 
case OP_SETATTR: 
case OP_SETCLIENTID: 
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RENAME 4res oprename; 

RENEW4res oprenew; 
RESTOREFH4res oprestorefh; 
SAVEFH4res opsavefh; 
SECINFO4res opsecinfo; 
SETATTR4res opsetattr; 
SETCLIENTID4res opsetclientid; 


case OP_SETCLIENTID_CONFIRM: 


case OP_VERIFY: 
case OP_WRITE: 


SETCLIENTID_CONFIRM4res 
opsetclientid_confirm; 

VERIFY4res opverify; 

WRITE4res opwrite; 


case OP RELEASE LOCKOWNER: 


case OP ILLEGAL: 


H; 


struct COMPOUND4args { 
utf8str_cs 
uint32 t 
nfs argop4 


D 


struct COMPOUND4res { 
nfsstat4 
utf8str_cs 
nfs_resop4 


D 


/* 


RELEASE _LOCKOWNER4res 
oprelease_lockowner; 
ILLEGAL4res opillegal; 


tag; 
minorversion; 
argarray<>; 


status; 
tag; 
resarray<>; 


* Remote file service routines 


af 


program NFS4 PROGRAM { 
version NFS V4 { 


} = 100003; 


Noveck 
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NFSPROCA NULL(void) = 0; 


COMPOUND4res 


NFSPROC4_COMPOUND (COMPOUND4args) = 


2015 


1; 
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/// /* 

/// .* NFS4 callback procedure definitions and program 
FH e 

/// struct CB_GETATTR4args { 

/// nfs fh4 fh; 

/// bitmap4 attr_request; 
/// )i 

/// 

/// struct CB_GETATTR4resok { 

/// fattr4 obj attributes; 
/// )i 

/// 


/// union CB_GETATTR4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// CB_GETATTR4resok resok4; 
/// default: 

/// void; 

/// )i 

/// 

/// struct CB_RECALL4args { 

/// stateid4 stateid; 

/// bool truncate; 

/// nfs_fh4 fh; 

TEEN 

Edd 

/// struct CB_RECALL4res { 

/// nfsstat4 status; 

/// )i 

/// 

/// /* 

/// * CB ILLEGAL: Response for illegal operation numbers 
JH EY 

/// struct CB ILLEGAL4res { 

/// nfsstat4 status; 

/// )i 

/// 

/// /* 

///  * Various definitions for CB COMPOUND 
LIL Ef 

/// enum nfs_cb_opnum4 { 

/// OP_CB_GETATTR = 3, 
/// OP_CB_RECALL = 4, 
/// OP_CB_ILLEGAL = 10044 
HF 

/// 
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/// union nfs cb argop4 switch (unsigned argop) { 


/// case OP_CB_GETATTR: CB_GETATTR4args opcbgetattr; 
/// case OP_CB_RECALL: CB_RECALL4args opcbrecall; 
/// case OP_CB_ILLEGAL: void; 

/// Y 

/// 

/// union nfs cb resop4 switch (unsigned resop) { 

/// case OP CB GETATTR: CB GETATTR4res opcbgetattr; 
/// case Op CB RECALL: CB RECALL4res opcbrecall; 
/// case OP CB ILLEGAL: CB ILLEGAL4res opcbillegal; 
FL 

/// 

/// 

/// struct CB_COMPOUND4args { 

/// utf8str_cs tag; 

/// uint32_t minorversion; 

/// uint32_t callback_ident; 

/// nfs cb argop4 argarray<>; 

dt 

/// 

/// struct CB_COMPOUND4res { 

/// nfsstat4 status; 

/// utf8str_cs tag; 

/// nfs cb resop4 resarray<>; 

ELL Es 

/// 

/// 

/// 

/// /* 


/// * Program number is in the transient range, since the client 
/// * will assign the exact transient program number and provide 
/// * that to the server via the SETCLIENTID operation. 


IIA- "4 

/// program NFS4_CALLBACK { 

/// version NFS_CB { 

/// void 

/// CB_NULL(void) = 0; 

/// CB_COMPOUND4res 

/// CB_COMPOUND (CB_COMPOUND4args) = 1; 
Eid } = 1; 


/// ) = 0x40000000; 
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3. Security Considerations 
See the Security Considerations section of [RFC7530]. 
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